<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  <meta http-equiv="Content-Style-Type" content="text/css">
  <title></title>
  <meta name="Generator" content="Cocoa HTML Writer">
  <meta name="CocoaVersion" content="949.54">
  <style type="text/css">
    body {background-color: #FFFFFF}
    p.p1 {margin: 0.0px 0.0px 0.0px 0.0px; font: 26.0px Helvetica}
    p.p2 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica}
    p.p3 {margin: 0.0px 0.0px 0.0px 0.0px; font: 12.0px Helvetica; min-height: 14.0px}
    p.p4 {margin: 0.0px 0.0px 12.0px 0.0px; font: 12.0px Helvetica}
    p.p5 {margin: 0.0px 0.0px 0.0px 49.0px; font: 12.0px Helvetica}
    p.p6 {margin: 0.0px 0.0px 0.0px 0.0px; text-align: center; font: 12.0px Helvetica}
    span.s1 {text-decoration: underline ; color: #1300ff}
    span.s2 {text-decoration: underline}
    span.Apple-tab-span {white-space:pre}
  </style>
</head>
<body>
<p class="p1"><b>cfilein</b></p>
<p class="p2">an input menu.</p>
<p class="p3"><br></p>
<p class="p2"><b>DESCRIPTION</b></p><br>
<p class="p2">This interactive menu allows the user to import a soundfile into the orchestra. When a file is chosen using this widget, Cecilia will scan the whole folder and create a dropdown menu with all the soundfiles within this folder to give a quick access to them.</p>
<p class="p3"><br></p>
<p class="p2">Many <b>cfilein</b>s are defined in an interface and appear under the input label in the left side 
	panel of the main window in the order defined.<span class="Apple-converted-space"> </span></p>
<p class="p3"><br></p>
<p class="p4">In the orchestra, you use the <i>variable_name</i> (between square brackets [ ]) as a parameter of an opcode 
	that requires a file path. The built-in UDO <b>tables</b> allows you to load a stereo soundfile into two Csound tables. 
	The output of the UDO <b>tables</b> is the numbers of the two function tables.</p>
<p class="p4">For further informations on the use of <b>cfilein</b>, refer to the <a href="./input.html">Input</a> section.</p>
<p class="p3"><br></p>
<p class="p2"><b>INTERFACE SYNTAX</b></p><br>
<p class="p2"><span class="Apple-tab-span">	</span><b>cfilein</b></p>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>(compulsory)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>variable_name</b> (mandatory, no spaces allowed)</p>
<p class="p2"><span class="Apple-tab-span">	</span>(optional)</p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="Apple-tab-span">	</span><b>-label</b> <span class="Apple-tab-span">	</span>Text showing in Cecilia slider pane (spaces allowed). Default value = ''</p>
<p class="p3"><br></p>
<p class="p2"><b>ORCHESTRA SYNTAX</b></p><br>
<p class="p2"><b><span class="Apple-tab-span">	</span></b>gi1, gi2 <b><i>tables [variable_name]</i></b>,<span class="Apple-converted-space"> </span></p>
<p class="p5"><i> </i></p>
<p class="p2"><b><i><span class="Apple-tab-span">	</span></i></b><i>gi1</i> and <i>gi2</i> are the numbers of the function tables containing the left and right channels of a stereo soundfile.</p>
<p class="p3"><br></p>
<p class="p2"><b>EXAMPLES</b></p><br>
<p class="p2"><span class="Apple-tab-span">	</span><span class="s2">In the interface panel</span> :</p>
<p class="p2"><span class="Apple-tab-span">	</span><b>cfilein</b> snd -label The sound input</p>
<p class="p3"><br></p>
<p class="p2"><span class="Apple-tab-span">	</span><span class="s2">In the orchestra</span> :</p>
<p class="p2"><span class="Apple-tab-span">	</span>gi1,gi2<span class="Apple-tab-span">	</span><b>tables</b><span class="Apple-tab-span">	</span>[snd]</p>
<p class="p2"><span class="Apple-tab-span">	</span>a1, a2 <span class="Apple-tab-span">	</span>diskin2<b><i><span class="Apple-converted-space">  <span class="Apple-tab-span">	</span></span>[variable_name]</i></b>, kpitch</p>
<p class="p2"><span class="Apple-tab-span">	</span>giTable <span class="Apple-tab-span">	</span>ftgen <span class="Apple-tab-span">	</span>100, 0, 1500, 1, <b><i>[variable_name]</i></b></p>
<center>
<p class="p3"><br><br></p>
<p class="p5">Return to <a href="./buildInterface.html">Building Cecilia's Interface</a> section</p>
<p class="p3"><br></p>
</center>
</body>
</html>
